<html>
<head>
    <title>XBRLAPI.ORG XBRL DIMENSION Example</title>
    <link rel="stylesheet" href="/css/styles.css" type="text/css"/>
    <script type="text/javascript">
        var gaJsHost = (("https:" == document.location.protocol) ? "https://ssl." : "http://www.");
        document.write(unescape("%3Cscript src='" + gaJsHost + "google-analytics.com/ga.js' type='text/javascript'%3E%3C/script%3E"));
    </script>
    <script type="text/javascript">
        try {
            var pageTracker = _gat._getTracker("UA-11401995-1");
            pageTracker._setDomainName("none");
            pageTracker._setAllowLinker(true);
            pageTracker._trackPageview();
        } catch (err) {
        }</script>
</head>


<body>

<div class="logo_container">
	<span class="logo">
		<a class="title" href="/">XBRLAPI</a>
	</span>
	<span class="logo_subscript">
		<a class="title" href="http://en.wikipedia.org/wiki/Free_and_open_source_software">Free Open-Source Software</a>
	</span>
</div>

<div id="navcontainer">
    <form action="http://www.xbrlapi.org/search.html" id="cse-search-box">
        <div>
            <input type="hidden" name="cx" value="partner-pub-3957505011939955:jqid48zd81o"/>
            <input type="hidden" name="cof" value="FORID:10"/>
            <input type="hidden" name="ie" value="ISO-8859-1"/>
            <input type="text" name="q" size="31"/>
            <input type="submit" name="sa" value="Search"/>
        </div>
    </form>

    <script
            type="text/javascript"
            src="http://www.google.com/cse/brand?form=cse-search-box&amp;lang=en">
    </script>

    <ul id="navlist">
        <li><a href="/">Home</a></li>
        <li><a href="..">Examples</a></li>
    </ul>

    <script type="text/javascript"><!--
    google_ad_client = "pub-3957505011939955";
    /* XBRLAPI site */
    google_ad_slot = "4927123290";
    google_ad_width = 160;
    google_ad_height = 600;
    //-->
    </script>
    <script type="text/javascript"
            src="http://pagead2.googlesyndication.com/pagead/show_ads.js">
    </script>

</div>

<div class="content">

    <h1>
        XBRLAPI Example: Organizing Facts along Dimensions using an Aspect Model and FactSet (with and without Explicit
        Dimensions)
    </h1>

    <h2>
        Author: Matt DeAngelis (ronin78 at gmail dot com)
    </h2>

    <h2>
        Contributor: Geoff Shuetrim (geoff at galexy.net)
    </h2>

    <h2>
        What is it?
    </h2>

    <p>
        This application extends the Base Utility Example to load an instance into the data Store, build an Aspect Model
        and FactSet from the Store, and demonstrate the retrieval of Aspect Values from the FactSet. By design, the
        implementation of the Loader in the Base Utility Example does not treat Explicit Dimensions as Aspect Values. In
        order to access these Values, an different Loader implementation must be used. This application demonstrates the
        use of each Loader and the results.

    </p>

    <h2>
        Where is it?
    </h2>

    <p>
        The home page for the XBRL API project can be found on the XBRLAPI
        project web site (http://www.xbrlapi.org/). There you also find
        information on how to download the latest release as well as all the other
        information you might need regarding this project.
    </p>

    <p>
        You can browse the <a
            href="http://xbrlapi.svn.sourceforge.net/viewvc/xbrlapi/trunk/module-examples/src/main/java/org/xbrlapi/data/bdbxml/examples/dimensions/DimensionExample.java?view=log">source
        code in SVN</a>.
    </p>

    <h2>
        Requirements
    </h2>

    <p>
        This application assumes that the user has a working installation of the XBRLAPI and uses the Berkeley XML
        Database implementation of the data Store. The author has set up the API in <a
            href="http://www.xbrlapi.org/installationDocumentation/eclipse.html">Eclipse</a> using the <a
            href="http://sourceforge.net/projects/xbrlapi/files/6.1/xbrlapi-6.1.jar/download">full JAR file</a>. All
        libraries found in the <a href="http://xbrlapi.svn.sourceforge.net/viewvc/xbrlapi/trunk/java/lib/">XBRLAPI SVN
        Repository</a> are included in the build path, and the Berkeley XML Database is installed with relevant
        libraries included.
    </p>

    <p>
        You can download any combination of the required XBRLAPI JARs from
        <a href="http://sourceforge.net/projects/xbrlapi/files/">Sourceforge</a>.
        You can get suggestions on necessary installation and configuration steps
        from <a href="http://www.xbrlapi.org">http://www.xbrlapi.org/</a>.
    </p>

    <h3>
        Program execution involves:
    </h3>

    <p>
        This application requires the same command line options as the Base Utility Example:
    </p>

    <ul>
        <li>-database [the directory that will hold the actual database data (rather than the Oracle Berkeley XML
            database binaries)]
        </li>
        <li>-container [the name of the file in the -database directory that will contain the data]</li>
        <li>-cache [the directory containing the document cache]</li>
    </ul>

    <p>
        These command line options can be entered in Eclipse by right-clicking the application file, clicking
        "Properties", and creating or editing the Launch Configuration to include the above options (under the
        "Arguments" tab, "Program Arguments").
    </p>

    <p>
        In addition, the user will have to set the "targetURI" variable in the program to the path to their chosen
        Instance document and the boolean "discoverXDT" variable to true or false. By default, I use the <a
            href="http://www.sec.gov/Archives/edgar/data/36047/000003604712000016/0000036047-12-000016-index.htm">CoreLogic
        2011 10-K filing</a>. Setting "discoverXDT" to false will use the default loader from the Base Utility Example;
        setting it to true will initialize a new Loader which will discover Explicit Dimension Aspects.
    </p>

    <p>
        See comments in the program for additional explanations.
    </p>

    <p>
        NOTE: This application is designed to run with an empty Store (so that the Store contains only the selected
        Instance document and the Loader is forced to do all discovery).

    <h2>
        Licensing and legal issues
    </h2>

    <p>
        XBRLAPI examples are released under the lesser GPL license.
    </p>

    <p>
        <a href="http://sourceforge.net/projects/xbrlapi"><img
                src="http://sflogo.sourceforge.net/sflogo.php?group_id=135539&type=11" width="120" height="30"
                border="0"
                alt="Get Java XBRL API implementation at SourceForge.net. Fast, secure and Free Open Source software downloads"/></a>
    </p>

</div>

</body>
</html>
